home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2001 May / SGI Freeware 2001 May - Disc 3.iso / dist / fw_apache.idb / usr / freeware / catman / a_man / cat8 / ab.Z / ab
Encoding:
Text File  |  2001-01-10  |  6.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      aaaabbbb((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 1111999999999999))))         aaaabbbb((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       ab - Apache HTTP server benchmarking tool
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       aaaabbbb [ ----kkkk ] [ ----iiii ] [ ----nnnn    _r_e_q_u_e_s_t_s ] [ ----tttt    _t_i_m_e_l_i_m_i_t ] [ ----cccc
  13.       _c_o_n_c_u_r_r_e_n_c_y ]    [ ----pppp _P_O_S_T _f_i_l_e ] [ ----AAAA _A_u_t_h_e_n_t_i_c_a_t_e
  14.       _u_s_e_r_n_a_m_e:_p_a_s_s_w_o_r_d ] [    ----PPPP _P_r_o_x_y _A_u_t_h_e_n_t_i_c_a_t_e
  15.       _u_s_e_r_n_a_m_e:_p_a_s_s_w_o_r_d ] [    ----HHHH _C_u_s_t_o_m _h_e_a_d_e_r ] [ ----CCCC    _C_o_o_k_i_e
  16.       _n_a_m_e=_v_a_l_u_e ] [ ----TTTT _c_o_n_t_e_n_t-_t_y_p_e ] [ ----vvvv    _v_e_r_b_o_s_i_t_y ] ] [    ----wwww
  17.       _o_u_t_p_u_t _H_T_M_L ]    ] [ ----xxxx <_t_a_b_l_e> _a_t_t_r_i_b_u_t_e_s ] ] [    ----yyyy <_t_r>
  18.       _a_t_t_r_i_b_u_t_e_s ] ] [ ----zzzz <_t_d> _a_t_t_r_i_b_u_t_e_s ]
  19.       [_h_t_t_p://]_h_o_s_t_n_a_m_e[:_p_o_r_t]/_p_a_t_h
  20.  
  21.       aaaabbbb [ ----VVVV ] [ ----hhhh ]
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.       aaaabbbb is    a tool for benchmarking    the performance    of your    Apache
  25.       HyperText Transfer Protocol (HTTP) server.  It does this by
  26.       giving you an    indication of how many requests    per second
  27.       your Apache installation can serve.
  28.  
  29.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  30.       ----kkkk          Enable the HTTP KeepAlive    feature; that is,
  31.               perform multiple requests    within one HTTP
  32.               session. Default is no KeepAlive.
  33.  
  34.       ----iiii          Use an HTTP 'HEAD' instead of the    GET method.
  35.               Cannot be    mixed with POST.
  36.  
  37.       ----nnnn _r_e_q_u_e_s_t_s The number of requests to    perform    for the
  38.               benchmarking session.  The default is to perform
  39.               just one single request, which will not give
  40.               representative benchmarking results.
  41.  
  42.       ----tttt _t_i_m_e_l_i_m_i_t
  43.               The number of seconds to spend benchmarking.
  44.               Using this option    automatically set the number
  45.               of requests for the benchmarking session to
  46.               50000.  Use this to benchmark the    server for a
  47.               fixed period of time.  By    default, there is no
  48.               timelimit.
  49.  
  50.       ----cccc _c_o_n_c_u_r_r_e_n_c_y
  51.               The number of simultaneous requests to perform.
  52.               The default is to    perform    one HTTP request at at
  53.               time, that is, no    concurrency.
  54.  
  55.  
  56.       ----pppp _P_O_S_T _f_i_l_e
  57.               A    file containing    data that the program will
  58.               send to the Apache server    in any HTTP POST
  59.               requests.
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 1/10/01)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      aaaabbbb((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 1111999999999999))))         aaaabbbb((((1111))))
  71.  
  72.  
  73.  
  74.       ----AAAA _A_u_t_h_o_r_i_z_a_t_i_o_n _u_s_e_r_n_a_m_e:_p_a_s_s_w_o_r_d
  75.               Supply Basic Authentication credentials to the
  76.               server. The username and password    are separated
  77.               by a single ':', and sent    as uuencoded data.
  78.               The string is sent regardless of whether the
  79.               server needs it; that is,    has sent a 401
  80.               Authentication needed.
  81.  
  82.  
  83.       ----pppp _P_r_o_x_y-_A_u_t_h_o_r_i_z_a_t_i_o_n _u_s_e_r_n_a_m_e:_p_a_s_s_w_o_r_d
  84.               Supply Basic Authentication credentials to a
  85.               proxy en-route. The username and password    are
  86.               separated    by a single ':', and sent as uuencoded
  87.               data.  The string    is sent    regardless of whether
  88.               the proxy    needs it; that is, has sent a 407
  89.               Proxy authentication needed.
  90.  
  91.  
  92.       ----CCCC _C_o_o_k_i_e _n_a_m_e=_v_a_l_u_e
  93.               Add a 'Cookie:' line to the request. The
  94.               argument is typically a 'name=value' pair. This
  95.               option may be repeated.
  96.  
  97.  
  98.       ----pppp _H_e_a_d_e_r _s_t_r_i_n_g
  99.               Append extra headers to the request. The
  100.               argument is typically in the form    of a valid
  101.               header line, usually a colon separated field
  102.               value pair, for example, 'Accept-Encoding:
  103.               zip/zop;8bit'.
  104.  
  105.  
  106.       ----TTTT _c_o_n_t_e_n_t-_t_y_p_e
  107.               The content-type header to use for POST data.
  108.  
  109.  
  110.       ----vvvv          Sets the verbosity level.     Level 4 and above
  111.               prints information on headers, level 3 and above
  112.               prints response codes (for example, 404, 200),
  113.               and level    2 and above prints warnings and
  114.               informational messages.
  115.  
  116.  
  117.       ----wwww          Print out    results    in HTML    tables.     The default
  118.               table is two columns wide, with a    white
  119.               background.
  120.  
  121.       ----xxxx _a_t_t_r_i_b_u_t_e_s
  122.               The string to use    as attributes for <table>.
  123.               Attributes are inserted <table hhhheeeerrrreeee >
  124.  
  125.       ----yyyy _a_t_t_r_i_b_u_t_e_s
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 1/10/01)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      aaaabbbb((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 1111999999999999))))         aaaabbbb((((1111))))
  137.  
  138.  
  139.  
  140.               The string to use    as attributes for <tr>.
  141.  
  142.       ----zzzz _a_t_t_r_i_b_u_t_e_s
  143.               The string to use    as attributes for <td>.
  144.  
  145.       ----VVVV          Display the version number and exit.
  146.  
  147.       ----hhhh          Display usage information.
  148.  
  149.      BBBBUUUUGGGGSSSS
  150.       There    are various statically declared    buffers    of fixed
  151.       length. Combined with    inefficient parsing of the command
  152.       line arguments, the response headers from the    server,    and
  153.       other    external inputs, these buffers might overflow.
  154.  
  155.       AAAAbbbb does not implement    HTTP/1.x fully;    instead, it only
  156.       accepts some 'expected' forms    of responses.
  157.  
  158.       The rather heavy use of ssssttttrrrrssssttttrrrr((((3333)))) by the program may skew
  159.       performance results, since it    uses significant CPU
  160.       resources.  Make sure    that performance limits    are not    hit by
  161.       aaaabbbb before your server's limit    is reached.
  162.  
  163.  
  164.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  165.       hhhhttttttttppppdddd((((8888))))
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 1/10/01)
  196.  
  197.  
  198.  
  199.